|
adTempus API
|
   |
ISecurityDescriptor::GetAceForName Method
|
adTempus API
|
|
Gets the ACE for the entity with the specified name
HRESULT GetAceForName(BSTR name, long flags, [out,retval] IADTAce ** pVal);
GetAceForName(String name, long flags, [out,retval] IADTAce * pVal);
Sub GetAceForName(name As String, flags As long, pVal As [out,retval] IADTAce *)
The ACE representing the requested user, or null if an error occurs.
This method returns an ACE representing the named security entity.
If the security descriptor already contains an ACE for that entity, a pointer to that ACE is returned. Otherwise, GetAceForName creates a new ACE (with no permissions), adds it to the descriptor, and returns it.
If the name cannot be resolved, the method fails with error ADT_E_NOT_FOUND.
Security names are specified using the form "[domain]name". For example:
SomeUser mydomainSomeUser SomeUserGroup builtinAdministrators
|
adTempus API Reference version 3.0.0.0, revised 10/30/2008
|